Boolean GetColor(where, prompt, inColor, outColor);

Point where; indicates dialog box's upper-left corner

Str255 prompt; a prompt string

RGBColor *inColor; is the starting color

RGBColor *outColor; is set to the last color value the user picks

The GetColor function displays the Color Picker dialog box on a screen.

where is the top left corner of the dialog box. The GetColor function can

display the dialog box and accept color selection on any screen, not

just the main screen. If you set where to (0,0), the dialog box is

positioned neatly on the main screen-centered horizontally, with

one-third of the empty space above the box and two-thirds below,

regardless of the screen size. If you set the where parameter to

(-1,-1), the GetColor function displays the dialog box on what the

Color Picker determines to be the best screen, optimizing depth

prompt is a text string that is displayed in the upper-left corner of the

inColor is the starting color, which the user may want for comparison; it is

displayed immediately below the current output color (the one the

outColor is set to the last color value the user picks before clicking OK. On

entry, the outColor parameter is treated as un defined, so the output

color sample initially matches the input. Although the color being

picked may vary widely, the input color sample remains fixed, and

clicking the input sample resets the output color sample to match it.

Returns: a Boolean value indicating whether the user wants to go ahead and

change to a new color or remain with the old one. If the user exits by

clicking the pointer arrow on the OK button, the new color is accepted

and a value of 1, or TRUE, is returned. By clicking on the Cancel

button, the user rejects the new color and a value of 0, or FALSE, is

Notes: inColor, or the color that's being considered for change, is displayed in the

dialog box directly under the outColor display area. The user gets an

immediate, side-by-side comparison of the two choices and can more easily

compare the visual consequences of either making a change or standing pat

and remaining with the initial color. The user can reset the outColor back

to the original by clicking on the sample inColor. Alternatively, exiting by

means of a click on Cancel also returns the value of outColor back to the